TECut

Cut selection range

#include <TextEdit.h> TextEdit

void TECut(hTE );

TEHandle hTE ; handle of an edit record

TECut copies the selection range to the desk scrap (or TextEdit private

scrap if you are using an old style TextEdit record) and removes it from the

edit record.

hTE is a handle obtained via TENew (old style TextEdit record) or

TEStylNew (new style TextEdit record). It leads to a

variable-length TERec structure and identifies the edit record to be

affected by this change.

Notes: If no selection range is identified, the scrap is emptied.

This places a 'TEXT' entry into the desk scrap. On a

edit record (see TEStylNew), this also stores a 'styl' entry in the scrap,

in the format of a variable-length STScrpRec structure.

Use TECopy to copy text (and styles) to the scrap without deleting it from

the edit record. Use TEDelete to delete the selection range without copying

it to the scrap.

If you are using the old style TextEdit record (required on pre-System 4.1

Macs), you'll need to use ZeroScrap and TEToScrap to copy the TextEdit

internal scrap into the system scrap and TEFromScrap for the the

reverse and use TEScrapHandle to get direct access to data in the

To save and restore styled text from a file, see Saving Styled Text.

Referenced by (30):